home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / ums / kms190b.lha / KMS / Doc / KMSUM.doc < prev    next >
Text File  |  1994-09-10  |  9KB  |  251 lines
  1.  
  2.  
  3.  
  4.          KMSUM 1.22 -*- KMS User Manager    ©1994 Thomas Schwarz
  5.          =======================================================
  6.  
  7.  
  8.  
  9.                                Documentation
  10.                                =============
  11.  
  12.  
  13.  
  14. Introduction:
  15. -------------
  16.  
  17. KMSUM is a GUI for editing the user  data  of  KMS,  my  famous  "Karfunkel
  18. Mailbox  System"  and  is  based  on  MUI, the even more famous "Magic User
  19. Interface" by Stefan Stuntz which has to be installed  on  your  system  in
  20. order to be able to use KMSUM.
  21.  
  22. KMSUM  makes  you able to change every data item of a KMS user which may be
  23. edited  by  the  KMS  internal  command  #25  "USERED",  but on a much more
  24. comfortable graphically nice-looking astonishingly pretty way.
  25.  
  26. KMSUM  is  designed  especially  for use with KMS and is not intended to be
  27. used  by anything or anybody for anything else. (But surely I'm not able to
  28. stop  you from abusing it anyway. If you abuse it, please tell me which way
  29. you do it. I simply can't imagine one :-)
  30.  
  31.  
  32.  
  33. Call-Syntax:
  34. ------------
  35.  
  36. KMSUM [Username]
  37.  
  38.  
  39.  
  40. Parameters:
  41. -----------
  42.  
  43. Username     Optional: If you supply the login name of a KMS user as an
  44.              argument, KMSUM directly presents the editing window for this
  45.              user, if it already exists, or lets you create a new user with
  46.              the given name.
  47.  
  48.  
  49.  
  50. Description:
  51. ------------
  52.  
  53. Main Window:
  54. ++++++++++++
  55.  
  56. If KMSUM is called without parameters, you will see the main window with  a
  57. list  of  all present KMS users and a number of buttons. You select an user
  58. from the list with a single mouseclick on  the  corresponding  name.  Every
  59. user specific action will then effect this single user.
  60.  
  61. If you call KMSUM with the name  of  a  KMS  user  given  as  command  line
  62. argument  you won't see this window and will be transported directly to the
  63. editing window described later on.
  64.  
  65. Available buttons/actions in the main window:
  66.  
  67. [   Up   ]        Move user one position up in the list.
  68. [  Down  ]        Move user one position down in the list.
  69.  
  70. [  Sort  ]        Sort users alphabetically.
  71.  
  72. [  Add   ]        Add new user to the list.
  73. [ Remove ]        Remove an user from the list.
  74.  
  75. [  Edit  ]        Change data of currently selected user.
  76.                   (also achieved by double-clicking in the listview)
  77.  
  78. You leave the program by clicking the  window  close  gadget  or  selecting
  79. "Quit" from the pull down menu.
  80.  
  81. Editing Window:
  82. +++++++++++++++
  83.  
  84. If you choose "Add" or "Edit" in the main  window  or  call  KMSUM  with  a
  85. command line argument, the KMSUM User Editor window is opened. Here you get
  86. the possibility to change the characteristics of the selected user.
  87.  
  88. I  think  the  meaning  of  all  the  available  string,  slider, cycle and
  89. checkmark  gadgets  are  quite  self  explanatory,  if  you are familiar to
  90. editing  userdata with the KMS internal command #25 "USERED", and so I will
  91. make my life easier here by just saying: "Read the documentation of USERED"
  92. :-)  Just  one thing though: The checkmark gadget "Ext. Write Opt." has got
  93. the functionality of the KMS internal command #26 "SCHREIBMODUS".
  94.  
  95. The available buttons do the following:
  96.  
  97. [  Use   ]        Accept changes and return to the main window.
  98. [ Cancel ]        Leave editor window without changing anything.
  99.  
  100.  
  101.  
  102. Distribution:
  103. -------------
  104.  
  105. The "Karfunkel Mailbox System (KMS)" and "KMS User Manager (KMSUM)" are
  106. Copyright ©1994 by Thomas Schwarz.
  107. All Rights Reserved.
  108.  
  109. "KMSUM" is only to be distributed as part of the KMS package.  I  mean  it.
  110. Please refer to the KMS documentation for further distribution information.
  111.  
  112.  
  113.  
  114. Author information:
  115. -------------------
  116.  
  117. It's me :-)
  118.  
  119. Thomas Schwarz
  120. Gieshügeler Straße 26
  121. 97218 Gerbrunn
  122. Germany
  123.  
  124. E-Mail: kmshq@bmagic.mayn.sub.de
  125.         Thomas_Schwarz@wue.maus.de
  126.  
  127.  
  128.  
  129. Acknowledgements:
  130. -----------------
  131.  
  132.                           This application uses
  133.  
  134.  
  135.                         MUI - MagicUserInterface
  136.  
  137.                 (c) Copyright 1993/94 by Stefan Stuntz
  138.  
  139.  
  140. MUI is a system to generate and maintain graphical user interfaces. With
  141. the  aid  of  a  preferences program, the user of an application has the
  142. ability to customize the outfit according to his personal taste.
  143.  
  144. MUI is distributed as shareware. To obtain a complete package containing
  145. lots of examples and more information about registration please look for
  146. a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
  147. your local bulletin boards or on public domain disks.
  148.  
  149.           If you want to register directly, feel free to send
  150.  
  151.  
  152.                          DM 30.-  or  US$ 20.-
  153.  
  154.                                   to
  155.  
  156.                              Stefan Stuntz
  157.                         Eduard-Spranger-Straße 7
  158.                              80935 München
  159.                                 GERMANY
  160.  
  161.  
  162.  
  163. Copyright notices:
  164. ------------------
  165.  
  166. Unix is a registered trademark of AT&T
  167.  
  168. Amiga is a registered trademark of Commodore Business Machines, Inc.
  169.  
  170. AmigaOS is a registered trademark of Commodore Business Machines, Inc.
  171.  
  172. KMS and KMSUM are not registered trademarks, but using them without
  173. permission is bad for your teeth.
  174.  
  175.  
  176.  
  177. Disclaimer:
  178. -----------
  179.  
  180.                           *** STANDARD DISCLAIMER ***
  181.  
  182.    This product is meant for educational purposes only.  Any  resemblance
  183.    to real persons, living or dead is  purely  coincidental.  Void  where
  184.    prohibited. Some assembly required. List each check separately by bank
  185.    number. Batteries not included. Contents may settle  during  shipment.
  186.    Use only as directed. No other warranty expressed or implied.  Do  not
  187.    use while operating a motor vehicle or heavy equipment.  Postage  will
  188.    be paid by addressee. Subject to CAB approval. This is not an offer to
  189.    sell securities. Apply only to affected area. May be too  intense  for
  190.    some viewers. Do not stamp. Use other side  for  additional  listings.
  191.    For recreational use only. Do not disturb. All models over 18 years of
  192.    age.   If   condition   persists,   consult   your    physician.    No
  193.    user-serviceable parts  inside.  Freshest  if  eaten  before  date  on
  194.    carton. Subject to change without notice. Times approximate. Simulated
  195.    picture. No postage necessary if mailed in the United States. Breaking
  196.    seal constitutes acceptance of agreement. For off-road  use  only.  As
  197.    seen on TV. One size fits all. Many suitcases look alike.  Contains  a
  198.    substantial amount of non-tobacco ingredients. Colors  may,  in  time,
  199.    fade. We have sent the forms which seem to be right for you.  Slippery
  200.    when wet. For office use only. Not affiliated with  the  American  Red
  201.    Cross. Drop in any mailbox. Edited for television. Keep cool;  process
  202.    promptly. Post office will  not  deliver  without  postage.  List  was
  203.    current at time of printing. Return to sender, no forwarding order  on
  204.    file,  unable  to  forward.  Not  responsible  for  direct,  indirect,
  205.    incidental or consequential damages resulting from any  defect,  error
  206.    or failure to  perform.  At  participating  locations  only.  Not  the
  207.    Beatles. Penalty for private use. See label for sequence.  Substantial
  208.    penalty for early withdrawal. Do not write below  this  line.  Falling
  209.    rock. Lost ticket pays maximum rate.  Your  cancelled  check  is  your
  210.    receipt. Add  toner.  Place  stamp  here.  Avoid  contact  with  skin.
  211.    Sanitized for your protection. Be sure each item is properly endorsed.
  212.    Sign here  without  admitting  guilt.  Slightly  higher  west  of  the
  213.    Mississippi. Employees and their families are not eligible. Beware  of
  214.    dog. Contestants have been briefed on some questions before the  show.
  215.    Limited time offer, call now to insure prompt delivery.  You  must  be
  216.    present to win. No passes accepted for this  engagement.  No  purchase
  217.    necessary. Processed at location stamped in code  at  top  of  carton.
  218.    Shading within a garment may occur. Use only in well-ventilated  area.
  219.    Keep away from fire or flame. Replace with  same  type.  Approved  for
  220.    veterans. Booths for two or more. Check here if tax  deductible.  Some
  221.    equipment shown is optional. Price does not include taxes. No Canadian
  222.    coins. Not recommended for children. Prerecorded for this  time  zone.
  223.    Reproduction strictly prohibited. No solicitors. No alcohol, dogs,  or
  224.    horses. No anchovies unless otherwise specified.  Restaurant  package,
  225.    not for resale. List at least two alternate dates. First pull up, then
  226.    pull down. Call toll free before digging. Driver does not carry  cash.
  227.    Some  of  the  trademarks  mentioned  in  this  product   appear   for
  228.    identification purposes only. Record additional transactions  on  back
  229.    of previous stub. Decision of judges is final.
  230.  
  231.    This supersedes all previous notices.
  232.  
  233.  
  234.  
  235. Conclusion:
  236. -----------
  237.  
  238.     A Thaum is the basic unit of magical strength. It has been universally
  239.   established as the amount of magic needed to create one small white pigeon
  240.                      or three normal sized billiard balls.
  241.                        -- (Terry Pratchett, The Light Fantastic)
  242.  
  243.  
  244.  
  245. Last words:
  246. -----------
  247.  
  248. Perhaps you wonder why this documentation is written in English while KMS
  249. in general is a German system? Well, I'm practising my English :-)
  250.  
  251.